home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / wbgames / getem / getem.english.doc < prev    next >
Text File  |  1996-04-07  |  11KB  |  317 lines
  1.  
  2.  
  3.  
  4.      Get´em        User's Manual        Get´em V 1.0
  5.  
  6.  
  7.  
  8.      NAME
  9.           Get´em - New Idea of Game.
  10.  
  11.      SYPNOSIS
  12.           [RUN] GETEM [?][F Filename]
  13.  
  14.           Or double-click on Icon or LevelFile.
  15.  
  16.      DESCRIPTION
  17.  
  18.           Find the matching pieces. Pieces falling downto floor,
  19.           when moved over free space. This is a complete new idea
  20.           of a Game. Nothing common with Tetris or Shanghai.
  21.           There is even an existing Version before Gem'x was ever released,
  22.           With a bit Sound, controlled by Mouse and Keyboard.
  23.           Nice Graphics, completely written in Pascal. (Kick-Pascal 1.0 and 2.03)
  24.  
  25.      COPYRIGHT © by Markus Illenseer 1990,1991.
  26.  
  27.           Getem V1.0 is freely distributable.
  28.           Getem V1.0 is free to be spread on public-domain and shareware disks
  29.           especially on Fred Fish's AmigaLibDisks, as long as they are sold for a
  30.           reasonable charge that is less than US $6 or DM 8.- .
  31.           For use in commercial products the permission of the authors is required.
  32.           Getem V1.0 may be copied and distributed via electronic networks such
  33.           as the Internet, also it may be held available on anonymous ftp-servers,
  34.           mail-boxes or BBS's.
  35.           The Copyright is still by the Authors.
  36.           The source may be changed or improved. Please DON'T spread your own
  37.           version of Getem under the  name of Getem, this will produce too
  38.           much confusion.
  39.           Just send us a note what you've changed, and if you really think it's
  40.           necessary to spread your own version, use another name.
  41.  
  42.           Kickpascal ® is registered Trademark of the Maxon-GmBM ®
  43.           Kickpascal is a product of the Himpire.
  44.  
  45.      AUTHOR
  46.    
  47.           This Program was written by 
  48.           Markus Illenseer
  49.           Große Kurfürstenstraße 1
  50.           W-4800 Bielefeld 1
  51.           Germany
  52.  
  53.           The fastest way to contact me is to EMAIL me:
  54.  
  55.           markus@TechFak.Uni-Bielefeld.DE
  56.  
  57.      INSTALLATION
  58.  
  59.           Copy the file GETEM1.0 , GETEM.DOC (GETEM.UPDATES ,GETEM.DOC.GER)
  60.           GETEMLEVELS and the file GETEMSOUND anywhere you want, 
  61.           e.g. Harddisk, Disk or RAM.
  62.           You mustn't put these files together in one Directory, 
  63.           but it would be better.
  64.           The easiest will be to copy the whole Directory.
  65.           
  66.      START
  67.    
  68.       HOW TO START
  69.  
  70.             Start Getem in the Directory you put it in with the
  71.             Level-File as shown above.  
  72.  
  73.             (Getem likes to use the CLI ! Please have in mind to have at 
  74.              least a Stack of 5000 Bytes !
  75.             Use:  
  76.                  RUN GETEM1.0 
  77.             as you have a multitasked System !
  78.         
  79.             While using Workbench, double-click GETEM-Icon. 
  80.             (Nice Icon, isn´t it ?)
  81.  
  82.             If you start Getem from other Directories, where the Level-File   
  83.             is not present (or to start with other, self-made Levels), then 
  84.             you have to add the Parameter F with the name of the Level-File:   
  85.           
  86.             RUN GETEM F PATH_TO_LEVEL_FILE:LEVEL_FILE 
  87.  
  88.             (e.g. Level-File is in RAM:  RUN GETEM F RAM:LEVEL )
  89.  
  90.             From Workbench:
  91.  
  92.             Double-Click GETEM and Shift+LevelFile
  93.  
  94.             If you add the Parameter " ? " , Getem prints a short help on your 
  95.             Screen, but won´t get start. ( Only CLI )
  96.  
  97.  
  98.             If there was any Problem, Getem will open a new Window to 
  99.             run ...
  100.             
  101.  
  102.           Then you will see a chess-alike-field, where there are many little
  103.           boxes in the Window (In the colors of your Workbench-Screen).
  104.           On the top side, you see some Gadgets and the Logo.
  105.           Also there is a Gadget in the top of the Window, in the
  106.           Drag-Bar, named ICON.
  107.           
  108.           Getem will then open a small Window with the Text 
  109.           'Loading: LEVEL_FILE_NAME' 
  110.         
  111.           This will take a while. (Depends on the length of the File,
  112.            the used Computer and the busyness of it...)
  113.  
  114.           If Getem can´t find the Level-File, there will be the Message:
  115.           'Can´t find the File: LEVEL_FILE_NAME'
  116.  
  117.           If so, Getem will compute Random-Levels. These Random-Levels 
  118.           can be UNSOLVABLE ! This was build in to play the game
  119.           without any loaded levels and to test the game.
  120.  
  121.           IF for instance the Levelfile was of wrong Data-Strukture,
  122.           Getem breaks with a warning. ( Thought was usefull to do so)
  123.  
  124.           Now GETEM loads the SoundFile. This File is a standard
  125.           8SVX-File and can easily replaced. There will be an
  126.           Error-Message if the File couldn't be find. Then GETEM will use the
  127.           Flash instead of the Digital-Sound. When yuo have installed
  128.           'InstallBeep' don´t bother of the new Sounds.
  129.  
  130.  
  131.           If all was going wrong or if the Level-File could be loaded,
  132.           then,
  133.  
  134.      STARTED
  135.  
  136.           your´re in Demo-Mode. Getem waits for clicking any
  137.           Gadget or Key, while waiting, Getem shows the loaded Levels
  138.           and makes some Graphics FX.
  139.  
  140.      GADGETS
  141.       
  142.       CLOSE
  143.           
  144.           Must I explain this one ? Ends my Game...
  145.  
  146.  
  147.       START
  148.      
  149.           If you click the START Gadget, it starts the
  150.           Game. Only Gadget which is ON when you start.
  151.         
  152.       ReGo
  153.  
  154.           The ReGo is for playing the same level once more, if you like.
  155.           (And sometimes it is the only way to make the Level...)
  156.           This Function was added to be more succesful, if you made
  157.           an Error. But, beware of the Time ! (Not yet in this Version)
  158.           This Gadget is ON, when the Game was started.
  159.  
  160.       STOP
  161.     
  162.           The STOP is for stopping the Game. If you can´t see these
  163.           f*@#¡ng boxes anymore, this is the best Gadget.
  164.           Only ON, when Game was started.
  165.  
  166.       SCORE
  167.  
  168.           Opens or Close a Window showing the Score of the last 10
  169.           Levels. The higher the Score, the better you are. The less the Time,
  170.           the higher the Score: Score= 60 / Time (s) * 1000.
  171.           Can be clicked anytime. Bool-Gadget.
  172.  
  173.       ICON
  174.          
  175.           If you click the ICON-Gaget, the Window will be iconified.
  176.           The Window is shrinked and moved to the upper left top of the Screen. 
  177.           If the Window is shrinked, you can Resize it with the ICON-
  178.           Gadget once again. The Game is paused, also the Demo, and
  179.           will be continued at the same Level and build of the Plane.
  180.           This function was build in for reasons of Big-Brothers-
  181.           Watching-You-In-Your-Company...
  182.  
  183.      KEYS
  184.  
  185.           There are some Keys always needed and some others...
  186.  
  187.       ESC
  188.  
  189.           This key is for quitting Getem while in Demo-Mode, not
  190.           during the Game ! (Security) It is also to quit the
  191.           Help-Window.
  192.  
  193.       i   (The little 'i')
  194.           
  195.           Boss-Key. Iconifys the Window. (s.ab)
  196.  
  197.       HELP
  198.  
  199.           Opens a window with a short helptext like this one...
  200.  
  201.  
  202.  
  203.      HOW TO PLAY
  204.  
  205.           Well, it is easy. Move your Mousepointer to the box you
  206.           want to move. Then press the RIGHT Mousebutton to move
  207.           Box to right, and LEFT Mousebutton to move Box to the
  208.           left. 
  209.  
  210.           If there is free space under the box, the box falls automagically 
  211.           to the bottom. 
  212.           
  213.           If it find any neighbour, (Left, right or below)
  214.           having same type then himself, these two (three) boxes disappears. 
  215.           It could be possible, that three boxes at the time
  216.           may disappear ! Say the fallig box finds two (three ?) neighbours at
  217.           the time ! This is important !
  218.  
  219.           On the right side you see a list of each type of box in
  220.           the game. So there you can look, if there are any triples
  221.           of boxes (Odd Number).
  222.  
  223.           For the best strategy, you must improve yourself.
  224.           Use unmatching pieces to move other pieces to left,
  225.           right at higher places...
  226.           Before starting a level, look at the list, to detect any
  227.           odd-numbers, look for traps or holes.
  228.  
  229.  
  230.      TO BE REMEMBERED
  231.  
  232.           This is a Start Release of the Game. It is strongly
  233.           recommended to report ANY Bug !!!!!!
  234.  
  235.      KNOWN BUGS
  236.  
  237.           In special strange cases, it is possible, that you can´t dis-
  238.           appear three boxes at the time. This depends how you do
  239.           it. I am working on. The problem: complete new Routine...
  240.  
  241.           Sometimes the sound goes mad... Don't know why...
  242.  
  243.      LEVEL-FILE
  244.  
  245.           You can make your own Level-File !! As many as you want. The game
  246.           will not end at the last level, it'll begin at the first level
  247.           again. First, there are the Levels, then you can insert a name for
  248.           every Level. The name should not have more than 50 Chars. You can
  249.           insert any sort of name like these ones: Timecruncher, Old Trap, Big
  250.           Hole, Lonley One.
  251.  
  252.           Here the structure of a Level:
  253.  
  254.               00000000000000       14 Rows, and 14 Columns.
  255.               00000000000000
  256.               70000000000000       0 is white Background.
  257.               07000303030300       1 is Quader
  258.               00700202020200       2 is Cross
  259.               00070101010100       3 is Pyramid
  260.               02027007020250       4 is Circle
  261.               03030700030300       5 is Sand
  262.               04040000040400       6 is Rowy
  263.               77777777777077       7 is Black box (Wall)
  264.               00000000000050
  265.               00000000000000
  266.               00000000000000
  267.               77777777077777
  268.  
  269.           Do not insert the numbers 8 and 9 ! (IMPORTANT)
  270.  
  271.  
  272.           Then insert a blank line (CR) or the Level-Name, to seperate two Levels.
  273.  
  274.           Structure of Level-File:
  275.  
  276.           0123
  277.           1223       (Yeah, of course 14 Rows and Columns ! )
  278.           7771
  279.           LevelName1
  280.           3232
  281.           3421
  282.           7651
  283.           LevelName2
  284.         
  285.           etc.
  286.  
  287.  
  288.      THE SOUND-FILE
  289.  
  290.          The included Sound-file is GETEMSOUND. This is a Sound wich
  291.          makes a noice like a Drip of Water. If this does not seems to be good
  292.          enough to you, you can change this file. Copy any 8SVX-File you want
  293.          to GETEMSOUND and you get the new Sound! But be care! Don´t use a long
  294.          Sound! This may cause long waits during the game. Because of speed,
  295.          the Sound is played with the double speed than usual.
  296.     
  297.      WHAT LEFT TO DO ?
  298.  
  299.           Some better Levels.      YOU can make your own ones !
  300.           Better Sound.            Is done with 8SVX-Loader.
  301.           Highscores.              Not sure wheater it is necessary.(implemented)
  302.           Timelimitation.          Must be done, next thing I am doing.
  303.           FASTER.                  Surely posible...
  304.           Perhaps better Gfx.      Yo ! And 4096 colors...
  305.           Levelgenerator and Editor... (Up to 8 Meg of Levels avail...,
  306.                                           just kidding !)  
  307.  
  308.      
  309.       ENJOY !
  310.  
  311. (Sorry, no nroff manual-page !)
  312.  
  313. Markus Illenseer. 
  314.  
  315. Oh. When I have time enough, then there will be a version for X11-Windos
  316. for Sparcs and DECs.
  317.